home *** CD-ROM | disk | FTP | other *** search
/ Belgian Amiga Club - ADF Collection / BS1 part 60.zip / BS1 part 60 / Imagemaster d4.adf / apa.lzh / hlp_arexx5 < prev    next >
Text File  |  1993-08-30  |  15KB  |  646 lines
  1. \ApAssist
  2. \: - This is the Quick Help for the ARexx in IM R/t -
  3. \: ----------------------------------------------------------
  4. \:   Written by David E. Patterson
  5. \: ----------------------------------------------------------
  6.  
  7. \font topaz.font 8
  8. \tc 1
  9. \wr
  10. \lj
  11. \dd "imh_descriptor"
  12.  
  13. \index "hlp_arexx2/askyn-cellular"
  14. \toc "hlp_toc/toc"
  15. \help "aa_help/help
  16.  
  17. \node "asterize"
  18. \title "Asterize"
  19. \next "autoactivate"
  20. \prev ""
  21. \{ \tc 15 Asterize/Ast \} - Puts a star-shaped effect on the screen.
  22.  
  23. \nw    
  24. Usage - '\{ \tc 15 asterize <red> <green> <blue> <width> <centersat>\} '
  25.         '\{ \tc 15 ast <red> <green> <blue> <width> <centersat>\} '
  26.             
  27. \{ \ts bu Sample Script\} :
  28.     
  29. options results;
  30. 'askrgb';
  31. colors = result;
  32. parse var colors red','grn','blu;
  33. 'askprop "Width(in pixels):"10 1 100';
  34. size=result;
  35. 'askprop "% Center Saturation Percent:"50 0 100';
  36. satur=result;
  37. options;
  38. '\{ \tc 15 asterize\} 'red grn blu size satur;
  39. 'redraw';
  40.     
  41. * User Interface: \{ \tc 11 Process Panel 
  42.                       Special Effects
  43.                           Asterize\}
  44.  
  45. \endnode
  46.  
  47. \node "autoactivate"
  48. \title "Auto Activate"
  49. \next "autoprimary"
  50. \prev "asterize"
  51. \{ \tc 15 Autoactivate \} - Changes automatic re-activation of main control
  52. panel.
  53.  
  54. \nw    
  55. Usage - '\{ \tc 15 autoactivate 0\} ' (off)
  56.         '\{ \tc 15 autoactivate 1\} ' (on)
  57.             
  58. \{ \ts bu Sample Script\} :
  59.              
  60. options results;
  61. 'askyn "Autoactivate ON" "Autoactivate OFF"';
  62. flag = result;
  63. options;
  64. '\{ \tc 15 autoactivate\} ' flag;
  65.   
  66. * User Interface: \{ \tc 11  Display Panel
  67.                        Auto-Activate\}
  68.  
  69. \endnode
  70.  
  71. \node "autoprimary"
  72. \title "Auto Primary"
  73. \next "autoredraw"
  74. \prev "autoactivate"
  75. \{ \tc 15 Autoprimary \} - Makes newly allocated buffer the primary buffer.
  76.  
  77. This directs the placement of new buffers.  In Mode 0, the new buffer does
  78. not become the primary unless there is no Primary Buffer.  In Mode 1, the new
  79. buffer always becomes the Primary Buffer.
  80.     
  81. \nw    
  82. Usage - '\{ \tc 15 autoprimary <mode>\} '
  83.     
  84. \{ \ts bu Sample Script\} :
  85.              
  86. options results;
  87. 'askyn "Autoprimary OFF" "Autoprimary ON"';
  88. flag = result;
  89. options;
  90. '\{ \tc 15 autoprimary\} ' flag;
  91.     
  92. \endnode
  93.  
  94. \node "autoredraw"
  95. \title "Auto Redraw"
  96. \next "backuptoundo"
  97. \prev "autoprimary"
  98. \{ \tc 15 Autoredraw \} - Turns redraw on or off.
  99.  
  100. \nw    
  101. Usage - '\{ \tc 15 autoredraw <mode>\} '
  102.     
  103. \{ \ts bu Sample Script\} :
  104.             
  105. options results;
  106. 'askyn "Autoredraw OFF" "Autoredraw ON"';
  107. flag = result;
  108. options;
  109. '\{ \tc 15 autoredraw\} ' flag;
  110.     
  111. \endnode
  112.  
  113. \node "backuptoundo"
  114. \title "Backup to Undo"
  115. \next "balance"
  116. \prev "autoredraw"
  117. \{ \tc 15 Backuptoundo \} - Copies the current primary buffer, making an UNDO
  118. possible.
  119.    
  120. Used before a process is performed to copy the initial contents of the
  121. primary buffer into the UNDO buffer, making an Undo possible. 
  122.     
  123. \nw   
  124. Usage - '\{ \tc 15 backuptoundo\} '
  125.     
  126. \{ \ts bu Sample Script\} :
  127.     
  128. '\{ \tc 15 backuptoundo\} ';
  129. 'area';
  130. 'areafill 100 120 190';
  131.  
  132. \endnode
  133.  
  134. \node "balance"
  135. \title "Balance"
  136. \next "blenddefs"
  137. \prev "backuptoundo"
  138. \{ \tc 15 Balance \} - White correction.
  139.     
  140. This Arexx command will determine the correction necessary to make the
  141. selected area 100% saturated white, and then will carry out the correction.
  142.  
  143. \nw    
  144. Usage - '\{ \tc 15 balance\} ' 
  145.     
  146. \{ \ts bu Sample Script\} :
  147.     
  148. 'area';
  149. '\{ \tc 15 balance\} ';
  150.     
  151. See also: \{ \ts b \tc 15 \link "gray" "hlp_arexx7/gray"\}  
  152.        
  153. * User Interface: \{ \tc 11 Process Panel
  154.                       Standard Adjustments
  155.                           White Balance\}
  156.  
  157. \endnode
  158.  
  159. \node "blenddefs"
  160. \title "Blend Definitions"
  161. \next "blendext"
  162. \prev "balance"
  163. \{ \tc 15 Blenddefs \} - Returns path and extension of a saved blend.
  164.  
  165. \nw    
  166. Usage - '\{ \tc 15 blenddefs\} '
  167.    
  168. \{ \ts bu Sample Script\} :
  169.     
  170. options results;
  171. '\{ \tc 15 blenddefs\} '
  172. parse var result path ','extension;
  173. options;
  174.  
  175. See also: \{ \ts b \tc 15 \link "imagedefs  " "hlp_arexx7/imagedefs"  
  176.           \link "macrodefs  " "hlp_arexx8/macrodefs"
  177.           \link "palettedefs" "hlp_arexx9/palettedefs"  
  178.           \link "renderdefs " "hlp_arexx10/renderdefs"\}
  179.               
  180.  
  181. \endnode
  182.  
  183. \node "blendext"
  184. \title "Blend Extensions"
  185. \next "blendload"
  186. \prev "blenddefs"
  187. \{ \tc 15 Blendext \} - Set a new extension for loading and saving blends.
  188.  
  189. \nw    
  190. Usage - '\{ \tc 15 blendext <newext>\} '
  191.     
  192. \{ \ts bu Sample Script\} :
  193.     
  194. '\{ \tc 15 blendext .bld\} '; 
  195.   
  196. See Also: \{ \ts b \tc 15 \link "imageext  " "hlp_arexx7/imageext" 
  197.           \link "macroext  " "hlp_arexx8/macroext"
  198.           \link "paletteext" "hlp_arexx9/paletteext"
  199.           \link "renderext " "hlp_arexx10/renderext"\}
  200.     
  201. * User Interface: \{ \tc 11    Setup Panel
  202.                         Blend Ext\}
  203. \endnode
  204.  
  205. \node "blendload"
  206. \title "Blend Load"
  207. \next "blendpath"
  208. \prev "blendext"
  209. \{ \tc 15 Blendload \} -  Loads a blend.
  210.  
  211. \nw    
  212. Usage - '\{ \tc 15 blendload <blendname>\} ' (without path or extension)
  213.     
  214. \{ \ts bu Sample Script\} :
  215.  
  216. 'blendpath work:blends';
  217. '\{ \tc 15 blendload myfile.ibp\} ';
  218. 'merge'; 
  219.     
  220. See Also:  \{ \tc 15 \ts b \link "loadasblend     " "hlp_arexx8/loadasblend"
  221.            \link "loadasbrush     " "hlp_arexx8/loadasbrush"
  222.            \link "loadasprimary   " "hlp_arexx8/loadasprimary"
  223.            \link "loadassecondary " "hlp_arexx8/loadassecondary"
  224.            \link "loadimask       " "hlp_arexx8/loadimask"    
  225.            \link "loadmask        " "hlp_arexx8/loadmask"\}
  226.                         
  227.  
  228. * User Interface:\{ \tc 11     Process Panel
  229.                            Load Blend\}
  230.  
  231. \endnode
  232.  
  233. \node "blendpath"
  234. \title "Blend Path"
  235. \next "Blueadj"
  236. \prev "blendload"
  237. \{ \tc 15 Blendpath \} - Set new path for loading and saving blends.
  238.  
  239. \nw    
  240. Usage - '\{ \tc 15 blendpath <newpath>\} '
  241.    
  242. \{ \ts bu Sample Script\} :
  243.  
  244. '\{ \tc 15 blendpath work:blends\} ';
  245. 'blendload myfile.ibp';
  246. 'merge'; 
  247.        
  248. See Also: \{ \tc 15 \ts b \link "imagepath  " "hlp_arexx7/imagepath"
  249.           \link "macropath  " "hlp_arexx8/macropath" 
  250.           \link "palettepath" "hlp_arexx9/palettepath"
  251.           \link "renderpath " "hlp_arexx10/renderpath"\}
  252.  
  253. * User Interface: \{ \tc 11    Setup Panel
  254.                         Blend Path\}
  255.                             
  256. \endnode
  257.  
  258. \node "blueadj"
  259. \title "Blue Adjust"
  260. \next "bluecont"
  261. \prev "blendpath"
  262. \{ \tc 15 Blueadj \} - Changes the blue brightness of selected area.
  263.  
  264. \nw    
  265. Usage - '\{ \tc 15 blueadj <amount>\} '
  266.     
  267. \{ \tc 15 Amount: 0 - 100\}
  268.             
  269. \{ \ts bu Sample Script\} :
  270.     
  271. 'area';
  272. '\{ \tc 15 blueadj 89\} ';
  273.     
  274. See Also: \{ \tc 15 \ts b \link "greenadj" "hlp_arexx7/greenadj"
  275.           \link "redadj  " "hlp_arexx10/redadj"\}
  276.               
  277. * User Interface: \{ \tc 11 Process Panel
  278.                         R,G,B Corrections            
  279.                             Blue\}
  280. \endnode
  281.  
  282. \node "bluecont"
  283. \title "Blue Contrast"
  284. \next "blur"
  285. \prev "blueadj"
  286. \{ \tc 15 Bluecont \} - Changes the blue contrast for a selected area.
  287.  
  288. \nw    
  289. Usage - '\{ \tc 15 bluecont <%>\} '
  290.  
  291. \{ \ts bu Sample Script\} :
  292.  
  293. 'area';
  294. '\{ \tc 15 bluecont 89\} ';
  295.     
  296. See Also: \{ \ts b \tc 15 \link "greencont" "hlp_arexx7/greencont" 
  297.           \link "redcont  " "hlp_arexx10/redcont"\}
  298.               
  299. * User Interface: \{ \tc 11  Process Panel
  300.                        R,G,B Corrections
  301.                           Blue Cont.\}
  302.  
  303. \endnode
  304.  
  305. \node "blur"
  306. \title "Blur"
  307. \next "bprint"
  308. \prev "bluecont"
  309. \{ \tc 15 Blur \} - Creates a motion blur effect. 
  310.  
  311. \nw    
  312. Usage - '\{ \tc 15 blur <length> <direction> [angle]\} '  
  313.     
  314. \{ \tc 15 length     -    in pixels\}
  315.     
  316. \{ \tc 15 direction  -    0 = up 
  317.                 1 = right
  318.                 2 = down
  319.                 3 = left 
  320.                 4 = arbitrary\}
  321.                     
  322. \{ \tc 15 angle      -    angle of arbitrary direction\}
  323.     
  324. \{ \ts bu Sample Script:\}
  325.     
  326. 'area';
  327. '\{ \tc 15 blur 30 2 45\} ';
  328.     
  329. See Also: \{ \ts b \tc 15 \link "smear" "hlp_arexx11/smear"
  330.           \link "warp " "hlp_arexx12/warp"\}
  331.  
  332. * User Interface: \{ \tc 11 Process Panel
  333.                        Geometric
  334.                            Motion Blur\}
  335.  
  336. \endnode
  337.  
  338. \node "bprint"
  339. \title "Blue Print"
  340. \next "bright"
  341. \prev "blur"
  342. \{ \tc 15 Bprint \} - Converts a selected region to blue line art.
  343.  
  344. \nw    
  345. Usage - '\{ \tc 15 bprint\} ' 
  346.     
  347. \{ \ts bu Sample Script\} :
  348.     
  349. 'area';
  350. '\{ \tc 15 bprint\} ';
  351.  
  352. See Also: \{ \tc 15 \ts b \link "lineart" "hlp_arexx8/lineart" \}
  353.     
  354. * User Interface: \{ \tc 11 Process Panel
  355.                        Special Effects
  356.                            Blue Print\}
  357.  
  358. \endnode
  359.  
  360. \node "bright"
  361. \title "Bright"
  362. \next "buffers"
  363. \prev "bprint"
  364. \{ \tc 15 Bright \} - Changes the brightness of a selected area.
  365.  
  366. \nw    
  367. Usage - '\{ \tc 15 bright <%>\} '
  368.     
  369. \{ \ts bu Sample Script\} :
  370.     
  371. 'area';
  372. '\{ \tc 15 bright 40\} ';
  373.     
  374. See Also: \{ \tc 15 \ts b \link "contrast" "hlp_arexx6/contrast"\}
  375.  
  376. * User Interface: \{ \tc 11Process Panel
  377.                      Standard Adjustments
  378.                         Brightness\}
  379.  
  380. \endnode
  381.  
  382. \node "buffers"
  383. \title "Buffers"
  384. \next "cancel"
  385. \prev "bright"
  386. \{ \tc 15 Buffers \} - Returns information about all buffers.
  387.  
  388. \nw    
  389. Usage - '\{ \tc 15 buffers\} ' 
  390.     
  391. \{ \ts bu Sample Script\} :
  392.    
  393. options results;
  394. '\{ \tc 15 buffers\} ';
  395. buffs = result;
  396. options;
  397. parse var buffs buffname','buffnumber;
  398.  
  399. \endnode
  400.  
  401. \node "cancel"
  402. \title "Cancel"
  403. \next "caric"
  404. \prev "buffers"
  405. \{ \tc 15 Cancel \} -  Equivalent to hitting the cancel gadget.
  406.  
  407. \nw    
  408. Usage - '\{ \tc 15 cancel\} ' 
  409.     
  410. \{ \ts bu Sample Script\} :
  411.      
  412. if(flag = 0) then;
  413. do
  414. '\{ \tc 15 cancel\} ';
  415. end;
  416.  
  417. \endnode
  418.  
  419. \node "caric"
  420. \title "Caricature"
  421. \next "cdef"
  422. \prev "cancel"
  423. \{ \tc 15 Caric \} - Creates an optical distortion similar to a concave lens.
  424.  
  425. Edges of a selected region are pulled toward the center creating a
  426. caricature.
  427.  
  428. \nw    
  429. Usage - '\{ \tc 15 caric <radius>\} '
  430.    
  431. \{ \ts bu Sample Script\} :
  432.     
  433. 'area'; 
  434. options results;
  435. 'askprop Radius: 50 0 100';
  436. radius = result;
  437. options;
  438. '\{ \tc 15 caric\} ' radius;
  439.     
  440. * User Interface: \{ \tc 11  Process Panel
  441.                       Geometric Transformations
  442.                           Caricature\}
  443.                           
  444. \endnode
  445.  
  446. \node "cdef"
  447. \title "Color Definition"
  448. \next "cellular"
  449. \prev "caric"
  450. \{ \tc 15 Cdef \} - Returns the average RGB, luma and variance of an area. 
  451.  
  452. Examines a selected region and returns red, green, blue, average, luma, and
  453. variance in a text string.
  454.  
  455. \nw    
  456. Usage - '\{ \tc 15 cdef\} ' 
  457.     
  458. \{ \ts bu Sample Script\} :
  459.      
  460. options results;
  461. '\{ \tc 15 cdef\} ';
  462. parse var result red','green','blue','average','variance;
  463. options;
  464.  
  465. * User Interface:\tc 11   Process Panel
  466.                         Define Color
  467.  
  468. \endnode
  469.  
  470. \node "cellular"
  471. \title "Cellular / Cell"
  472. \next "channel"
  473. \prev "cdef"
  474. \{ \tc 15 Cellular / Cell \} - Creates a \{ \ts i glass block effect\} . 
  475.  
  476. Pixels are manipulated as points inside a cell, the resulting effect is
  477. similar to looking through a wall of thick glass bricks.
  478.  
  479. \nw    
  480. Usage - '\{ \tc 15 cellular <red> <green> <blue> <cellsize> <borderflag>\} '
  481.         '\{ \tc 15 cell <red> <green> <blue> <cellsize> <borderflag>\} '
  482.             
  483.             Red:         0 - 255
  484.             Green:       0 - 255
  485.             Blue:        0 - 255
  486.             Cellsize:    (In Pixels)
  487.             Borderflag:  0 = No, 1 = Yes
  488.        
  489. \{ \ts bu Sample Script\} :
  490.     
  491. 'area';
  492. options results;
  493. 'askrgb';
  494. colors = result;
  495. parse var colors red','grn','blu;
  496. 'askprop Cell_Size: 50 0 100';
  497. cell = result;
  498. 'askyn "No Border Flag" "Border Flag"';
  499. flag = result;
  500. options;
  501. '\{ \tc 15 cellular\} ' red grn blu cell flag; 
  502.        
  503. * User Interface: \{ \tc 11   Process Panel
  504.                         Special Effects
  505.                             Point Cellular\}
  506. \endnode
  507.  
  508. \node "channel"
  509. \title "Channel"
  510. \next "clip"
  511. \prev "cellular"
  512. \{ \tc 15 Channel \} - Specifies colors to be affected by a blend.
  513.  
  514. \nw    
  515. Usage - '\{ \tc 15 channel <red> <green> <blue>\} '
  516.     
  517.     Red:     0 = not affected, 1 = affected
  518.     Green:   0 = not affected, 1 = affected
  519.     Blue:    0 = not affected, 1 = affected
  520.      
  521. \{ \ts bu Sample Script\} :
  522.           
  523. 'area';
  524. '\{ \tc 15 channel\} ' 0 1 0; /* green gun only */
  525. 'merge';
  526.     
  527. \endnode
  528.  
  529. \node "clip"
  530. \title "Clip"
  531. \next "cliphalf"
  532. \prev "channel"
  533. \{ \tc 15 Clip \} - Clips selected region to a new buffer
  534.  
  535. A selected region is clipped to a new buffer.  If a buffer name is not
  536. specified the program will automatically generate one.
  537.         
  538. \nw    
  539. Usage - '\{ \tc 15 clip [newname]\} '
  540.     
  541. \{ \ts bu Sample Script\} :
  542.      
  543. 'area';
  544. '\{ \tc 15 clip testbuff\} ';
  545.     
  546. See Also: \{ \tc 15 \ts b \link "cliphalf" "hlp_arexx5/cliphalf"\}
  547.     
  548. * User Interface: \{ \tc 11   Process Panel
  549.                        Re-Sizing and Clipping
  550.                            Clip Region\}
  551. \endnode
  552.  
  553. \node "cliphalf"
  554. \title "Clip_Half"
  555. \next "Clip2"
  556. \prev "clip"
  557. \{ \tc 15 Cliphalf \} - Clips selected region to a buffer half it's size.
  558.  
  559. \nw    
  560. Usage - '\{ \tc 15 cliphalf [newname]\} '
  561.     
  562. \{ \ts bu Sample Script\} :
  563.    
  564. 'area';
  565. '\{ \tc 15 cliphalf testbuff\} ';
  566.     
  567. See Also: \{ \ts b \tc 15 \link "clip" "hlp_arexx5/clip"\}
  568.     
  569. * User Interface: \{ \tc 11   Process Panel
  570.                        Re-Sizing and Clipping
  571.                            Clip .5 X\}
  572.  
  573. \endnode
  574.  
  575. \node "Clip2"
  576. \title "Clip 2X"
  577. \next "close"
  578. \prev "cliphalf"
  579. \{ \tc 15 Clip2 \} - Doubles the selected region and clips it to a new
  580. buffer.
  581.  
  582. \nw    
  583. Usage - '\{ tc 15 clip [newname]\} ';
  584.     
  585. \{ \ts bu Sample Script\} :
  586.     
  587. 'area';
  588. '\{ \tc 15 clip2 testbuff\} ';
  589.    
  590. See Also: \{ \ts b \tc 15 \link "clip    " "hlp_arexx5/clip"
  591.           \link "cliphalf" "hlp_arexx5/cliphalf"\}
  592.     
  593. * User Interface: \{ \tc 11   Process Panel
  594.                        Re-Sizing and Clipping
  595.                             Clip2\}
  596.  
  597. \endnode
  598.  
  599. \node "close"
  600. \title "Close"
  601. \next "colchange"
  602. \prev "Clip2"
  603. \{ \tc 15 Close \} - Immediate exit from Imagemaster.
  604.  
  605. Terminates operations immediately, unless used with the optional parameter
  606. prompt.  Adding the word 'prompt' allows the user to close or continue.
  607.     
  608. \nw    
  609. Usage - '\{ \tc 15 close [prompt]\} '
  610.     
  611. \{ \ts bu Sample Script\} :
  612.     
  613. if(flag = 0) then;
  614. do
  615. '\{ \tc 15 close prompt\} ';
  616. end;
  617.     
  618. * User Interface: \{ \tc 11 Exit IM\}
  619.  
  620. \endnode
  621.  
  622. \node "colchange"
  623. \title "Color Change"
  624. \next ""
  625. \prev "close"
  626. \{ \tc 15 Colchange \} - Allows user to preset color change values.
  627.  
  628. Presets the color change values that are used for the grey balance, white
  629. balance, geographic elevations, and shadowed geographic elevations.
  630.     
  631. \nw    
  632. Usage - '\{ \tc 15 colchange <red> <green> <blue> <average> <variance>\} '
  633.         
  634. \{ \TS BU Sample Script\} :
  635.     
  636. 'area';
  637. '\{ \TC 15 colchange 134 106 137 123 137\} ';
  638. 'balance';
  639.      
  640. * User Interface: \{ \tc 11   Process Panel 
  641.                           Standard Adjustments 
  642.                             Color Balance\}
  643.  
  644. \endnode
  645.  
  646.